home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / olrdrs / mm10.zip / MIKEMAYL.DOC < prev    next >
Text File  |  1993-06-13  |  50KB  |  1,255 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.      If these are docs, then this must be software. If this is software,
  8.      ┌──────────────────────┐  then I must have stuck with this project
  9.      │ ▓▓   ▓▓   ▓▓   ▓▓    │  longer than I thought! Below is all you
  10.      │ ▓▓▓ ▓▓▓   ▓▓▓ ▓▓▓    │  will need to get MikeMayl going, both
  11.      │ ▓▓ ▓ ▓▓ike▓▓ ▓ ▓▓ayl │  quickie and full-on instructions.
  12.      │                      │  There isn't a lot to it... if you've
  13.      │      Version 1.0     │  used another reader (which I'm sure
  14.      │  (c) Copyright 1993  │  most of you have) then you'll be
  15.      │                      │  able to figure 99% of MikeMayl out
  16.      │ The QWK Mail Reader  │  on your own. You'll only to need to
  17.      │  for the CheapSkate! │  know what keys do what or where to
  18.      └──────────────────────┘  point your mouse. We'll start with
  19.      an overview of MikeMayl's features followed by a detailed
  20.      explanation of MikeMayl's usage.
  21.  
  22.  
  23.      -=≡ Who, What, When, Where and Why ≡=-
  24.  
  25.      MikeMayl was written by me, Mike May. I had thought up the name
  26.      MikeMayl about 2 years ago and always wanted a QWK reader to attach
  27.      the name to. After coming across a file written by Patrick Lee
  28.      describing the QWK format, I figured I'd dig out the ol' compiler
  29.      and put together a quick QWK *viewer*, just for the heck of it.
  30.      Well one thing led to another and with the help of Allen Porter who
  31.      1. Was my CoSysop at the time (The Ice House is down but it wants
  32.         to come back!)
  33.      2. Helped write the docs you're reading.
  34.      3. Was forced into becoming the alpha/beta/crash tester.
  35.      finally became reality. MikeMayl has taken about 6 months, off and
  36.      on, to get to this point. As the project progressed I decided that
  37.      I would make it freeware simply because I enjoyed writing it.
  38.      There are plenty of shareware/commercial readers available so it
  39.      appeared that there was a need for a reader that was absolutely
  40.      free of charge. This also frees me of any obligation to improve the
  41.      program in the future although I do have many plans for MikeMayl. I
  42.      wanted to release MikeMayl quite some time ago, but I kept saying,
  43.      "Just one more feature...". So here it is, as much as I could pack
  44.      into a first release and still leave room for improvement.
  45.  
  46.      If you'd like to communicate with me, I can be found in the RIME
  47.      Offline Reader conference and the RIME BBS Software conference
  48.      where I have made many friends <half-truth!>. Speaking of BBS
  49.      Software, MikeMayl works extremely well with GAP and GAPs QWK door,
  50.      MainMail. The file sending and receiving features work flawlessly
  51.      with these products. MikeMayl's file attaching specs mirror those
  52.      introduced by MSI so MikeMayl should send and receive files with
  53.      Wildcat! BBS's as well.
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                 Page 1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.                                                          MikeMayl v1.0
  70.  
  71.  
  72.  
  73.      -=≡ RETRO ≡=-
  74.  
  75.      You've found a BBS you'd really like to 'hang around' on.
  76.      They've got plenty of message bases just bursting at the seams
  77.      with useful technical information, the latest jokes, or just
  78.      plain cozy conversation.  BUT you have been given 30 minutes per
  79.      day to access this fine BBS.  And even if you were given more
  80.      time every day, you'd just use it downloading files!  Besides,
  81.      the Sysop would have to give you 2 hours every day to read the
  82.      number of conferences you are interested in.  Hence the
  83.      existence of the Offline Mail Door and ultimately, of MikeMayl!
  84.  
  85.      An Offline Mail Door allows users to select conferences they
  86.      want to read, set their message pointers (reference numbers of
  87.      the last messages a user has read), download mail in archived
  88.      packets called QWK packets, and upload replies in archived
  89.      packets called REP packets.
  90.  
  91.  
  92.      -=≡ MikeMayl Features ≡=-
  93.  
  94.      Read QWK mail packets (as received from MainMail, CamMail,
  95.      Qmail, TomCat, etc. doors) and create REP (reply) packets.
  96.  
  97.      Select the archiving/unarchiving program of your choice.
  98.  
  99.      View Bulletins, New Files, News, Welcome, and Goodbye screens.
  100.  
  101.      Manage and steal taglines.
  102.  
  103.      Automatic PostLink Routing.
  104.  
  105.      Select recipients of messages from a picklist.
  106.  
  107.      Twit people and subjects.
  108.  
  109.      Shell to DOS.
  110.  
  111.      Send and Receive files attached to messages.
  112.  
  113.      Shell to your communications program.
  114.  
  115.      Seamless integration with external tagline managers such as TLX.
  116.  
  117.      Search for messages containing a particular string.
  118.  
  119.      Mouse support.
  120.  
  121.      All while saving big bucks because MikeMayl is -=FREE=-
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.                                                                 Page 2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.                                                          MikeMayl v1.0
  136.  
  137.  
  138.  
  139.      -=≡ Where to find MikeMayl ≡=-
  140.  
  141.      Ron Hossack of The Solid Rock BBS has agreed to be the sole
  142.      'official' distribution point for MikeMayl. While I hope that
  143.      MikeMayl will spread on its own, The latest version will always
  144.      be available on Ron's BBS. You can reach it at 909-785-9176.
  145.  
  146.      -=≡ Quick Start Directions ≡=-
  147.  
  148.      1. Make a directory for MikeMayl, MM for example.
  149.  
  150.      2. Copy the MM10.ZIP file into this directory.
  151.  
  152.      3. UNZIP the MM10.ZIP file into this directory.
  153.  
  154.      4. Type MM10 and you're done!
  155.  
  156.      Well... you may need to know the following:
  157.  
  158.      There is only 1 file MikeMayl *needs* in order to run (besides
  159.      YOUR editor!), MM10.EXE. A couple of other files will make use
  160.      easier though. When MM starts up it looks for a configuration
  161.      file, MIKEMAYL.CFG. It if doesn't find it, MikeMayl will
  162.      automatically invoke MAKECFG.EXE (which *should* be in the ZIP
  163.      *and* in the MikeMayl directory. Before shelling to MAKECFG,
  164.      MikeMayl will have assigned default values to all variables and
  165.      you will use MAKECFG to change whatever variables are incorrect.
  166.      If MikeMayl cannot find MAKECFG, it will make its own
  167.      configuration file and run anyway!
  168.  
  169.      Here's a description of the miscellaneous files that can be in
  170.      the MM directory.
  171.  
  172.      MIKEMAYL.CFG: This is an ASCII text file and can be edited by
  173.      the user at any time using either the MAKECFG.EXE program or an
  174.      ASCII text editor.  The first time you run MikeMayl (unless you
  175.      elected to run MAKECFG.EXE first), a message will appear letting
  176.      you know that no MIKEMAYL.CFG file could be found and a generic one
  177.      will be created for you.
  178.  
  179.      MikeMayl will also accept a configuration file other than
  180.      MIKEMAYL.CFG. If you start either MikeMayl or MAKECFG with a
  181.      command line named configuration file, both programs will use this
  182.      named configuration file. For example, starting MikeMayl like this;
  183.      MIKEMAYL MIKEMAYL.CF1 will instruct MikeMayl to read MIKEMAYL.CF1
  184.      instead of MIKEMAYL.CFG. If MIKEMAYL.CF1 does not exist, MikeMayl
  185.      will create one and then allow you to modify it from the Main Menu
  186.      using MAKECFG. You can also start MAKECFG with the line MAKECFG
  187.      MIKEMAYL.CF1 to edit this configuration file.
  188.  
  189.      MAKECFG.EXE: This is the configuration editor and can be used to
  190.      edit MIKEMAYL.CFG (or any other configuration file as described
  191.      above) from within MikeMayl or stand-alone. Documentation for MAKECFG
  192.      can be found later in this file.
  193.  
  194.  
  195.                                                                 Page 3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.                                                          MikeMayl v1.0
  202.  
  203.  
  204.  
  205.      MIKEMAYL.TAG: This is your tagline file. I'm sure there is a
  206.      limit to its length, but at this point I don't know what that
  207.      limit is. Tags can be up to 58 characters wide.  This file can
  208.      be edited with an ASCII text editor, or through MikeMayl itself
  209.      when entering messages.
  210.  
  211.      MIKEMAYL.TWT: This is the Twit file. Any person whose messages
  212.      annoy you should have their name put in this file, one name to a
  213.